Configuring a Search Path

RTX64 does not support a current working directory for real-time processes. In the Search Path Control Panel page, you can configure a search path to allow RTX64 to look in specific directories when you attempt to load an RTSS application or RTDLL. Once a search path is set, you can load applications and RTDLLs by specifying a base filename only, assuming one of the directories in the search path contains the file you want to load.

NOTE: You must be a member of the RTX64Administrators user group to modify the search path. For more information on user groups, see User Groups and Access Permissions.

Sections in this topic:

Opening this Page in RTX64 Control Panel
Default Search Paths
Adding a New Directory to the Search Path
Removing a Directory from the Search Path
Changing the Order of Directories in the Search Path

Opening this Page in RTX64 Control Panel

To open this page in the Control Panel:

In the Start menu, navigate to RTX64 4.5 Runtime and click RTX64 Control Panel.
Click Configure the RTSS Subsystem > Configure Subsystem Environment.

Default Search Path

The default search path is used in these situations:

when running RTSS applications
when real-time applications load RTDLLs. Loading an RTDLL also searches the directory containing the application’s RTSS module prior to searching the directories in the search path.

Adding a New Directory to the Search Path

Choose a method to add a directory:

Click the Add button:

Do one of the following:

Click Browse (...) and navigate to the directory you want to add to the search path and click OK.
Enter the path name in the editable field, and then click Enter. Copy/Paste is supported.

NOTE: Each directory in the search path must be an absolute path, ending with a forward slash (/).

NOTE: Each directory in the search path must contain less than 253 characters. Note that the characters in the name of a file you try to load via the search path are included in the 253-character limit. A directory and file name combination that exceeds this limit will result in an error.

NOTE: You may experience a delay when you attempt to load an application or RTDLL if your search path contains several directories. Each directory that is added to the search path may result in a longer delay.

NOTE: The order of directories in the search path is important. When the search path is used, the directories within the search path are searched in order, beginning with the first directory and ending with the last.

Removing a Directory from the Search Path

To remove a directory from a search path:

Click the directory you want to remove from the search path.
Click the Delete button.

Changing the Order of Directories in the Search Path

The order of directories in the search path is important. When the search path is used, the directories within the search path are searched in order, beginning with the first directory, and ending with the last. You can move a directory in the search path up or down to change its search priority.

To change the order of directories in a search path:

Click the directory whose search priority you want to change.
Change the order:

Click the up arrow (˄) to move the directory up in the search path, increasing its search priority.
Click the down arrow (˅) to move the directory down in the search path, decreasing its search priority.